home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
rbbs_pc
/
msgtos20.zip
/
SPAZ_150.LZH
/
SPAZ.DOC
< prev
next >
Wrap
Text File
|
1990-10-07
|
9KB
|
256 lines
------------------------------------------------------------------
SPAZ 1.50
October 7, 1990
By Dan Thomson, Andrew Farmer and Jeffrey Nonken.
USER MANUAL
Copyright (c) 1989-1990 Dan Thomson and Andrew Farmer.
All Rights Reserved.
------------------------------------------------------------------
--------------------
THE LEGAL BUSINESS
--------------------
Spaz is guaranteed only to take up space on your hard disk. Use
it at your own risk. No warranty is stated or implied. The
authors shall not be responsible for any damages resulting from
it's use, directly or indirectly.
Spaz is distributed as a Freely Available Copyrighted Program,
no fee may be charged for distribution and the distribution
archive is not to be tampered with or altered in ANY way.
Spaz cannot be distributed in a modified form of any sort.
Modified Source code, likewise, may NOT be distributed. If you
are planning on porting the code to another operating system, or
have code changes that you think are highly beneficial, then
please contact the authors directly for assistance or guidance.
While Spaz is freely available for use in non-corporate
environments, donations to the authors will always be gratefully
accepted.
The Authors may be contacted at the following network addresses:
Dan Thomson 1:163/115.3@fidonet
Andrew Farmer 1:163/115.0@fidonet
Jeffrey Nonken 1:273/715.0@fidonet
-----------------------------------------
THE DISTRIBUTION ARCHIVE (SPAZ_150.ZIP)
-----------------------------------------
This archive should have included the following files:
SPAZ.DOC - The Documentation, you read it as we speak.
SPAZ.NEW - Changes since 1.40.
SPAZ.COM - The Executable Program.
SPAZ.ASM - The Complete Assembler Source Code.
--------------
WHAT IT DOES
--------------
Spaz checks the archive to determine it's type, sorts the
contents by date/time to ensure proper mail distribution and
calls the appropriate unarchive program to extract the contents.
If you use the /N command line option, the Sorting will NOT
occur.
Spaz is idealy suited to netmail activities where it can auto
detect incoming archives and extract them transparent to the
calling program.
If the Archive is a standard (ARC compatible) Archive, it will
search first for Pkxarc, then PkUnPak, Pak and ArcE in that
order, until it finds one on the path. If you use the /A
command line option, then ArcE will be used exclusively..no
other program will be searched for.
If the Archive contains Crushed or Distilled files, as created by
the Pak Program, Spaz will not attempt to use any other
Un-Archiver it will simply search for and use Pak.
If the Archive was created by ZOO Spaz will search first for Looz
and then for Zoo, in that order, until it finds one on the path.
If the Archive was created by DWC, then Spaz will not attempt to
use any other Un-Archiver it will simply search for and use DWC.
If the Archive was created by PKZIP, then Spaz will not attempt
to use any other Un-Archiver it will simply search for and use
PkZip.
If the Archive was created by LHARC, then Spaz will not attempt
to use any other Un-Archiver it will simply search for and use
LHARC.
NOTE: SPAZ can be renamed to ARCE.COM to be used with OPUS 1.03,
or it can be used with Confmail by using the '/A SPAZ' option. If
you rename Spaz to ArcE be sure to have one of the other
un-archivers on the Path, (and don't use the /A switch)
otherwise Spaz would be calling ArcE, which would be itself so
you'd have an endless loop on your hands.
SPAZ can also be used in a batch file (multitasking systems) as
it understands wildcard filenames. This will remove the memory
overhead of having Confmail shell to an Unarchiver. If used with
the /D option, spaz will even delete the archives once processed
(if the extract was successful.
------------------------------
DISK AND MEMORY REQUIREMENTS
------------------------------
1. DOS 2.11 or greater.
2. Enough disk space for a 2nd copy of the archive to be processed.
3. At least 16K of RAM, plus room to load the Un-Archiver.
4. At least 2 available handles. (files= statement in config.sys).
---------------------
COMMAND LINE SYNTAX
---------------------
Usage: SPAZ [switches] Path/Archive [switches] [file...] [file...]
Items enclosed in Square Brackets ([]) are entirely optional.
Switches:
* -A
Causes Spaz to search for ArcE (and ONLY ArcE) when
un-archiving a standard Arc Compatible Archive.
* -D
Causes Spaz to delete the Archive once Extract is
successful. By default it is NOT deleted.
* -F
Causes Spaz to unpack ONLY Network Compressed Mail bundles
in the specified directory. It will look for .MO?,.TU?,
etc. files and unpacked them all into the default
directory.
When this switch is used the Archive name as specified on
the the command line should be the Path to your Inbound
area, NOT a FileName.
The -D (Delete) and -O (Overwrite) switches are forces ON
by the use of the -F switch. Likewise the -N (NoSort)
switch is forced OFF.
Due to the lack of an Overwrite mode in Looz, if this
switch is used only Zoo will be called to process Zoo
Archives, NEVER Looz.
* -Maddress
Causes Spaz to expand the name of each file, and try to
gleen the sending Net/Node address. This switch will, or
course, only work properly on Compressed Mail bundles
coming in over the Net.
This switch must be followed by the 'address' pararmeter,
which should be YOUR Net/Node address.
* -N
Causes the Archive Sort NOT to be performed. Since the
sort doesn't take up much more memory, it is strongly
suggested that you DO NOT use this switch for NetMail
related tasks.
* -O or -R
Causes Spaz to run in Overwrite Mode. You will NOT be
prompted if a file with the same name as that being
extracted already exists in the directory, the existing
file will simply be overwritten.
Due to the lack of an Overwrite mode in Looz, if this
switch is used only Zoo will be called to process Zoo
Archives, NEVER Looz.
* -V
Cause Spaz to run off at the mouth. Displays run-time
configuration settings.
----------
EXAMPLES
----------
* Spaz -D 02986534.MO1
This would sort, then un-archive the bundle and delete it
when finished.
* Spaz -N 02986534.MO1
This would Un-Archive the bundle but would not attempt
to sort them and would not delete when finished.
* Spaz -D -N *.MO?
This would process all files matching the wildcard specs
but would not attempt to sort them and would delete when
finished.
* Spaz -N HELLO.ARC -Q *.TXT -O
This would only extract files with an extension of TXT, it
would not sort the archive, it would operate in quiet mode
& overwrite mode would be used.
* Spaz -F D:\BINK\INBOUND
This would Sort, extract from, then delete any file
matching the description of a Standard FidoNet<tm>
Compressed Mail bundle.
* Spaz -F -M163/115 D:\BINK\INBOUND
On 163/115 this would Sort, extract from then delete any
file matching the description of a FidoNet<tm> Compressed
Mail bundle. It would also tell me what node sent the
bundle.
---------------------=*[ IMPORTANT WARNING ]*=----------------
* Spaz -D HELLO.ARC *.EXE
This would only extract files with an extension of EXE, it
would then DELETE THE ENTIRE ARCHIVE. Be extreamly careful
with the -D switch if you are only extracting specific
files.
----------------
CLOSING NATTER
----------------
If you have any problems you can't fix or questions you can't
answer then please contact one of us via NetMail. We will
always do our best to support the software, but it is, by
definition un-supported. We will answer queries as time allows,
please be patient when awaiting a reply.
----------------------------------------------------------------------